home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 16 / Mac Magazin and MacEasy Magazine CD - Issue 16.iso / Datenbanken & Hypercard / kalk105 folder / Kalk 1.0.5 Read Me (SimpleText) < prev   
Text File  |  1995-10-23  |  6KB  |  68 lines

  1. Kalk 1.0.5
  2.  
  3. What is Kalk
  4. Kalk is a simple RPN calculator, with a 20-level stack, that knows the four basic operations plus some trig and log functions.
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20. Design Goals
  21. There are lots of desktop calculators out there. Why one more? I made this one for my own personal use, because I wanted a RPN calculator, but not that huge monsters I’ve seen around, almost complete implementations of scientific HP machines. Those were great calculators, but they filled almost the whole screen with tens of buttons and switches. At the end of one week I usually was back to the classic Apple calc, because it’s small, fast, doesn’t create auxiliary files on the disk, and doesn’t have big manuals.
  22. So, the first goal on Kalk design was to make its window the same size of Apple’s. Then remove all digit buttons from the panel, making area for more information (six of the 20 levels of the stack are shown). The only buttons remaining are those used everytime and those that are hard to remember without a label. Digits are entered via the keyboard, and the special functions are grouped on the “Kalk” menu.
  23.  
  24. Using Kalk
  25. Using Kalk is very like doing simple math on a 28- or 48-series HP calculator. As for the Apple calc, the numeric keypad of your keyboard (hope you have one) is the best choice. When you type digits, the Edit Line (E:) is turned on. You can use it like any Macintosh text field, using arrows, selecting, deleting, copying, cutting, pasting, etc. When you press Enter the Edit Line is turned off and its contents are pushed into the stack. As with HP calculators, you don’t need to press Enter all the times; if you use an operator in edit mode, Enter is pressed automatically for you.
  26.  
  27. Operation (Keyboard Shortcuts and Hidden Features)
  28. (these shortcuts are available online while using Kalk; look at the “?” Menu)
  29. •    +, -, /, *: the basic four operators are used directly from the keyboard
  30. •    Enter: you can press Return, or Enter on the keyboard
  31. •    Swap: you can use the = key
  32. •    Drop: you can use Option-= or Delete (Delete only works as Drop if the edit line is empty)
  33. •    CHS: you can use Option-<minus>
  34. •    Clear: you can use the Clear key, or Esc, or “Clear” on the “Edit” menu
  35. •    π: you can enter an approximation of π by pressing p, P, π , or ∏. This may be useful for trig calculations, since sin and cos on the Kalk menu are performed with degrees (not rads).
  36. •    The “E:” on the Edit Line changes to red boldface when there are less than five free levels on the stack.
  37.  
  38. •    “Edit First Line” (Command-E) puts the first line of the stack into the edit line.
  39. •    If you press Enter with an empty edit line, the current first level is duplicated (Dup).
  40. •    Copy and Cut puts the contents of the first level only into the clipboard.
  41. •    Paste is quite different. It actually “plays” any text that’s in the clipboard through the same general input procedure, just as if it was being typed. You can copy a list of values (separated by “returns”) from a text editor or spreadsheet and paste into Kalk: the values will be entered into the edit line, and the “returns” will be interpreted as Enters, filling the stack automatically. Bad digits (not valid numbers) will be filtered out, the same way they are when you type. If there are Kalk special characters in clipboard text (+, -, /, *, π, ≠, =, option-<minus>) they will be interpreted also, making Kalk minimally “programmable” in RPN form.
  42. •    Kalk remembers the stack and window position after Quit, unless you lock the application file.
  43. • You can change Kalk’s background texture on the “Desktop Patterns” Control Panel (System 7.5 or higher only). Just open the control panel, select a pattern and press the Option key to change the button from “Set Desktop Pattern” to “Set Utilities Pattern”. This will change the background of most Apple utilities (Key Caps, Calculator, Find File, etc.).
  44. • The beep sound can also be changed. Just add a System 7 sound file named “Kalk Beep” to your System suitcase.
  45.  
  46. Kalk is free. Please drop a note to say something about it, including bugs and suggestions.
  47.  
  48.  
  49. Version History
  50. 1.0ß1    First public release
  51. 1.0 Not released
  52. 1.0.1    Included the ability to enter negative exponents. Two other small bugs on "Paste" corrected. Please note that characters in text to be pasted are interpreted just like typed ones, so negative exponents must be written with option-minus. Added a “Kalk Shortcuts” menu item and dialog, in the Help/Guide menu.
  53. 1.0.2  and 1.0.3  not released (their bugs were corrected (I hope) in 1.0.4
  54. 1.0.4 Added a gray background and 3-D looking buttons. These are the original 1.0 Beta Kalk buttons, and their code allow interesting future developments. Kalk no longer looks different under Greg’s Buttons. Kalk no longer beeps when the Help/Guide menu is hidden or missing in the host system
  55. 1.0.5 Added boldface to the red near-full alarm, so it can be seen on non-color screens. Added ability to use alternative beep sound and background pattern (thanks Matthew for the pattern tip).
  56.  
  57. Legal Stuff
  58. As the author of this software I naturally reserve all rights to it for myself, the sole exception being the right to freely distribute copies of the software, provided the Read Me files are included with it and no exchange of funds is involved. This software is not in the public domain; rather it is Copyright ©1995 by Claudio Terra (with parts Copyright ©1991–4 Symantec Corporation since it was written in Think C 5.0 and Symantec C++ 7.04).
  59. Furthermore, I make no warranty with respect to the quality of this software, nor do I warrant that its operation will be error-free. The software is provided “as is” and without warranty of any kind, express or implied. The author claims no liability for data loss or any other problems caused directly or indirectly by use of the “Kalk” application.
  60. This software may be included in any disk or CD-ROM library of public domain and shareware software sold by a non-profit organization.  This software may not be included in any commercial software collection sold for profit, nor may it be bundled with any commercial software, hardware, books, or other media without the prior written consent of the author.
  61.  
  62. Claudio Terra
  63. Rua do Oriente, 311
  64. Rio de Janeiro, RJ 20240-130
  65. BRAZIL
  66.  
  67. Internet e-mail: terra@inf.puc-rio.br
  68.